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User' s  Mamual  for  GREAT JRTC 

VERSION  1.0 

1 .  General . 

1.1  Purpose  of  User's  Manual. 

The  objective  of  the  User's  Manual  for  CREATJRTC  is  to  provide  the 
information  necessary  for  the  user  to  effectively  use  the  autv^iV.aLecI 
information  system  to  create  mission  databases  derived  from  the  Joint 
Readiness  Training  Center  I-MILES  data. 

1.2  Project  references. 

Baldwin,  J.  D.  (1990,  August) .  User's  Guide  to  the  ARI-JRTC  Mission 
Database .  (Research  Note  BDM/ARI-TR-0018-90)  Presidio  of  Monterey,  Ca: 
U.  S.  Army  Research  Institute  Field  Unit. 

1.3  Terms  and  Abbreviations. 

DBA  Database  Administrator. 

DBMS  Database  Management  System  is  software  that  provides  for 

easy  access  to  data  by  non-programmers. 

INGRES  Software  product  of  INGRES  Inc.  It  is  the  DBMS  that 
ARI-POM  is  currently  using  to  store  the  mission 
databases . 

PC  Personal  Computer  from  the  INTEL  family  of 

microprocessors  with  the  Microsoft  Corp.  Disk  Operating 
System  (DOS) 

QUEL  QUEry  Language  used  by  the  INGRES  DBMS  software . 

VAX  Virtual  Address  extended.  This  is  the  name  used  by  the 

Digital  Equipment  Corporation  for  their  family  of 
computing  machines. 

VMS  Virtual  Memory  System.  This  is  the  name  used  by  the 

Digital  Equipment  Corporation  for  their  operating  system 
used  with  the  VAX  family  of  computers. 

1 . 4  Security . 

This  program  shall  be  available  to  the  database  administrator  for 
use  at  his/her  discretion.  Knowledge  of  the  USER  account  and  PASSWORD 
will  limit  its  use  to  those  certified  by  the  DBA. 

2.  System  summary. 

2.1  System  overview. 

This  program  is  intended  to  create  a  mission  database  using  the  I- 
MrLES  data  collected  at  the  JRTC.  It  will  be  run  interactively  by  the 
database  administrator  to  create  a  single  database  per  execution  of  the 
program. 


1 


7 


2.2  System  operation. 


GREAT .TRTC  has  four  sources  of  inputs.  They  are:  a)  the  event  data 
file  (rotation.dat),  b)  the  player  file  (either  the  player.dat  or  the 
rotation. pid  files),  c)  the  weapon  type  file  (systera.dat),  and  d)  user 
input  derived  from  the  JRTC  Take  Home  Package.  The  output  from  GREAT JRTC 
is  a  mission  database  on  the  VAX  computer.  Data  is  pre-processed  on  a 
personal  computer  prior  to  uploading  to  the  VAX  system. 

2.3  System  configuration. 

This  software  is  designed  to 
operate  on  any  of  the  Digital 
Equipment  Gorp.  fcimily  of  VAX 
computers  running  under  VMS  and 
having  INGRES  DBMS  installed. 

Data  is  transferred  from  a  DOS 
machine  (IBM  compatible  PG)  to  the 
VAX  using  KERMIT  or  XMODEM  and 
then  processed  on  the  VAJ(  into  a 
mission  database  (see  Figure  1) . 

2 . 4  System  organization . 

The  software  organization  of 
GREAT JRTG  is  FORTRAN  (v.  77)  with 
embedded  QUEL  statements.  The 
program  uses  the  embedded  QUEL 
statements  to  interface  with  the 
INGRES  (V.  6.3)  database 

structures . 

2 . 5  System  performance . 

GREATJRTG  is  an  interactive  program.  The  time  it  takes  to  create 
a  mission  database  is  dependent  on  the  volume  of  data  to  be  converted  to 
the  INGRES  subsystem.  An  average  time  for  a  JTTG  phase  will  be 
approximately  15  minutes.  At  this  rate,  a  JRTG  rotation  can  be  loaded 
in  less  than  a  single  day. 

2 . 6  Contingencies  and  alternate  modes  of  operation . 

No  provision  for  alternate  modes  of  operation  is  provided. 

2.7  Database/data  bank. 

GREATJRTG  uses  an  INGRES  database,  ARIDMS,  to  record  information 
about  the  databases  it  has  created  or  will  create.  The  MISSION  table  is 
the  receptacle  of  this  data.  The  following  is  a  description  of  this 
table  and  the  colvimns  that  are  entered  by  GREATJRTG: 

Name:  mission 

Owner :  tacdb 

Location:  db_ingres 

Type:  user  table 

Row  width:  89 

Storage  structure:  heap 


Figure  1.  Data  flow  showing  transfer 
of  data  from  floppy  disk  to  VAX. 
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column  name 

type 

length 

mstart 

c 

20 

mend 

c 

20 

mhistory 

c 

6 

msegment 

integer 

1 

mtype 

c 

10 

morg 

c 

15 

mtf 

c 

1 

mdbname 

c 

12 

2.8  General  description  o£  Inputs,  processing,  outputs. 

Inputs ;  As  stated  in  section  2.2,  there  are  four  sources  of  input 
for  GREAT J^TC.  The  primary  source  for  inputs  to  the  program  is  the  JRTC 
Take  Home  Package . 

a)  JRTC  Phase  start  date  -  date  /  time  of  the  phase  start  time, 
found  in  the  Take  Home  Package.  This  is  usually  the  event  of 
issuing  the  OPORD.  This  field  must  be  manually  entered  by  the 
database  administrator. 

b)  JRTC  Phase  end  time  -  date  /  time  of  the  phase  end  time,  found 
in  the  Take  Home  Package.  This  is  usually  the  event  labeled 
as  'Change  of  Mission' .  This  field  must  be  manually  entered 
by  the  DBA. 

c)  JRTC  Rotation  -  the  rotation  number  as  recorded  on  the  Take 
Home  Package.  This  is  a  four  digit  number  entered  by  the  DBA. 

d)  JRTC  Phase  (1-5)  -  the  mission  phase  as  reported  in  the  Take 
Home  Package.  This  must  be  manually  entered  by  the  DBA. 

e)  JRTC  Iteration  -  the  sequence  number  of  the  scenario  being 
trained  for.  This  is  implied  by  the  number  of  times  a 
particular  mission  is  conducted  during  a  rotation.  This 
information  is  derived  by  the  DBA  and  manually  entered  into 
the  program. 

f)  JRTC  mission  type  -  mission  as  reported  in  the  Take  Home 
Package.  Program  will  only  accept  standard  mission  types  as 
defined  by  the  data  input  screen  edits,  (i.e.  D  ATK  for 
deliberate  attack,  DEF  BP  for  defend  battle  position,  etc.). 
This  must  be  manually  entered  by  the  DBA. 

g)  Organization  of  Participants  -  those  units  that  are  at  the 
JRTC  training.  This  information  is  found  on  the  cov“r  sheet 
of  the  Take  Home  Package.  Progreun  will  search  for  this  and 
try  to  fill  this  field  during  the  execution  of  the  program. 

h)  Mission  battalion  /  task  force  -  L{ight)  forces 

In  addition  to  inputs  from  the  THP,  the  program  constructs  the 
database  name  from  the  above  fields  (c,d,e  and  h)  and  uses  this  name  to 
search  the  MISSION  tcible  of  ARIDMS  to  see  if  this  database  already 
exists.  If  it  does,  the  program  will  not  allow  the  creation  of  two 
databases  with  the  same  name.  A  message  to  this  effect  is  displayed  on 
the  terminal  to  notify  the  DBA. 
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Processing;  CREATJRTC  places  an  entry  in  the  MISSION  table  of  ARIDMS 
and  then  proceeds  with  the  creation  of  the  database. 

Output :  The  MISSION  table  of  ARIDMS  has  a  row  appended  to  it,  as 
described  in  2.7  above.  All  columns  are  updated  by  the  program  except 
for  'org',  which  is  not  known  until  the  database  is  created. 

3.  Functions  related  to  technical  operations. 

3.1  Initiation  procedures. 

In  order  to  process  the  I-Miles  data  from  the  JRTC,  it  first  must 
be  converted  from  the  DBASE  III  format  to  an  ASCII  format.  This  should 
be  accomplished  on  the  PC  using  the  DBMSCOPY  software  for  DBASE  III  files 
to  ASCII  (this  is  an  option  of  DBMSCOPY  when  you  install  it  on  your  hard 
disk  drive).  The  general  syntax  of  the  command  is  as  follows; 

C;\DBMSCOPY>DBMSCOPY  a;9003.dbf  [fixed] a ; 9003 . ascii 

C ; \DBMSCOPY>DBMSCOPY  a; player. dbf  [ fixed] a ; player . ascii 

C;\DBMSCOPY>DBMSCOPY  a;9003.pid  [fixed] a;pid. ascii 

C ; \DBMSCOPY>DBMSCOPY  a;system.dbf  [fixed] system. ascii 

The  first  file,  rotation .dbf ,  is  required  and  either  of  the  second 
or  third  files  may  be  used  (player. dbf  is  recommended)  .  The  fourth  file, 
system. dbf,  is  a  static  file  and  need  not  be  converted  with  each  rotation 
unless  it  has  changed  at  the  JRTC.  When  these  files  have  been  converted 
to  an  ASCII  format,  they  may  be  uploaded  to  the  VAX  system  into  the  disk 
area  DUAl; [tacdb2. jrtc. rotation] .  Either  Kermit  or  XModem  may  be  used 
to  transfer  the  files  from  a  PC  to  the  VAX  computer  system. 

3.2  Input  requlretoenta. 

It  is  necessary  for  the  DBA  to  have  the  JRTC  Take  Home  Package  at 
the  time  the  databases  are  created.  This  is  necessary  for  the  input 
requirements  to  the  program  as  most  of  these  data  are  contained  within 
the  THP. 


3.2.1  Input  fortnata . 

The  following  are  the  formats  needed  for  input  to  CREATJRTC; 


JRTC  Phase  start  date; 

JRTC  Phase  end  date; 
JRTC  Rotation; 


JRTC  Phase; 

JRTC  Iteration; 

JRTC  Mission  type; 
Battalion  /  task  force; 


valid  date  -  time  format  as  follows; 
dd-Mmm-yy  hh;mm;ss. 

same  as  Missio..  start  date  above. 

JRTC  assigned  rotation  specified  with 
the  following  format;  YYRR  where 

YY  Fiscal  year  as  90,  91  etc. 

RR  Rotation  sequence  number, 

from  01  to  14. 

Training  exercise  sequence  number  from 
1  to  5. 

Training  scenario  sequence  number. 

any  one  of  the  following;  D  ATK,  H  ATK, 
C  ATK,  DEF  SEC,  DEF  BP,  RECON,  MTC. 

I (nfantry) 
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3.2.2  Conposltlon  rules. 

See  3.2.1  Input  formats  above  for  any  composition  rules. 

3.2.3  Input  vocabulary . 

See  3.2.1  Input  formats  above  for  input  vocabulary. 

3.2.4  Sanple  inputs . 

Figure  2  is  an  example  of  the  data  entry  screen  for  entering  JRTC 
data  from  the  Take  Home  Package.  The  example  uses  the  9003  rotation  for 
its  input  data.  This  is  the  only  screen  that  need  be  entered  by  the  Data 
Base  Administrator. 


3 . 3  Output  requirements . 


An  entry  is  made  in  a  parameter  database,  ARIDMS,  that  helps  the 
system  in  the  building  of  the  database  and  for  system  maintenance  of  the 
mission  database  sets.  This  entry  is  used  to  determine  if  a  database 
already  exists,  and  to  help  categorize  the  data  within  the  mission 
database . 

3.3.1  Output  formats. 

The  output  is  a  record  in  the  MISSION  table  of  the  ARIDMS  database. 
The  columns  of  the  MISSION  table  of  the  ARIDMS  database  are  the  same  as 
those  outlined  in  Section  3.2.1  Input  formats,  above. 

3.3.2  Saaple  outputs. 


A  sample  row  of  data  from  the  MISSION  table  looks  like  this: 


Imstart  (mend  fmhlsto(rnseg(mtype 

- + - 

Imcrg 

|mtf  lelrpl IgndpI Imdbname 

1  02-Dec-89  03:19:53  I  02-Dec-89  05:15:16  19003  1  IIRECON 

1 

|L  1  01  0IJ903L  02 

- + - + - + - + - 

5 


3.3.3  Output  vocabulary . 

No  discussion  of  output  is  needed  for  this  program. 

3.4  Utllxzation  o£  ayatem  outputa. 

No  discussion  of  the  utilization  of  tho  system  outputs  is  provided. 

3.3  Recovery  and  error  correction  procedurea. 

Should  the  program  fail  to  construct  a  complete  database,  it  is 
necessary  to  destroy  the  database  as  well  as  remove  the  entry  in  the 
MISSION  table  of  the  ARIDMS  database.  Once  this  is  done,  you  may  rerun 
the  GREAT JRTC  program  to  construct  the  mission  database  again. 
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